Nomination

Nominal Assign

menta supports the integration of ticket nomination, allowing each ticket to be assigned to a specific individual at the time of issuance. To implement this feature, it is necessary to include additional information with each ticket during the creation process. This information should be provided within ticket.nominalTicket and can include both fullName and identification.

Integration Example

To create nominal tickets, you should use the following endpoint:

cURL

Here is an example of how to notify menta of a ticket issuance with fictional data using cURL.

    curl -X POST 'https://api.mentatickets.com/v1/tickets'
    -H 'Authorization: YOUR_API_KEY'
    -H 'Content-Type: application/json'
    --data-raw '[
        {
            "ticketOptionId": "0001",
            "showId": "4726",
            "externalReferenceEventId": "the-lion-king-broadway",
            "buyer": "buyer@emaildomain.com",
            "ticketId": "111",
            "ticketAccess": {
                "type": "URL",
                "locator": "https://storage.googleapis.com/default_mentatickets-core/Captura%20de%20pantalla%202023-03-21%20a%20la(s)%2010.46.42.png",
                "status": "LOCKED"
            },
            "nominalTicket": {
                "fullName": "John Doe",
                "identification": "12345678"
            }
        }
    ]'

Python

Here is an example of how to notify menta of a ticket issuance with fictional data using Python.

import requests
import json

url = "https://api.mentatickets.com/v1/tickets"
headers = {
    "Authorization": "YOUR_API_KEY",
    "Content-Type": "application/json",
}

ticketOptionId = "0001"
showId = "4726"
externalReferenceEventId = "the-lion-king-broadway"
buyer = "buyer@emaildomain.com"
ticketId = "111"
ticketAccessType = "URL"
locator = "https://storage.googleapis.com/default_mentatickets-core/Captura%20de%20pantalla%202023-03-21%20a%20la(s)%2010.46.42.png"
status = "LOCKED"

data = [
    {
        "ticketOptionId": ticketOptionId,
        "showId": showId,
        "externalReferenceEventId": externalReferenceEventId,
        "buyer": buyer,
        "ticketId": ticketId,
        "ticketAccess": {
            "type": ticketAccessType,
            "locator": locator,
            "status": status,
        },
        "nominalTicket": {
            "fullName": "John Doe",
            "identification": "12345678"
        }
    }
]

response = requests.post(url, headers=headers, data=json.dumps(data))

Java

Here is an example of how to notify menta of a ticket issuance with fictional data using Java.

import okhttp3.*;
import java.io.IOException;

OkHttpClient client = new OkHttpClient();
MediaType JSON = MediaType.get("application/json; charset=utf-8");

String ticketOptionId = "0001";
String showId = "4726";
String externalReferenceEventId = "the-lion-king-broadway";
String buyer = "buyer@emaildomain.com";
String ticketId = "111";
String ticketAccessType = "URL";
String locator = "https://storage.googleapis.com/default_mentatickets-core/Captura%20de%20pantalla%202023-03-21%20a%20la(s)%2010.46.42.png";
String status = "LOCKED";

String json = String.format("""
        [
            {
                "ticketOptionId": "%s",
                "showId": "%s",
                "externalReferenceEventId": "%s",
                "buyer": "%s",
                "ticketId": "%s",
                "ticketAccess": {
                    "type": "%s",
                    "locator": "%s",
                    "status": "%s"
                },
                "nominalTicket": {
                    "fullName": "John Doe",
                    "identification": "12345678"
                }
            }
        ]
        """, ticketOptionId, showId, externalReferenceEventId, buyer, ticketId, ticketAccessType, locator, status);

RequestBody body = RequestBody.create(JSON, json);
Request request = new Request.Builder()
        .url("https://api.mentatickets.com/v1/tickets")
        .post(body)
        .addHeader("Authorization", "YOUR_API_KEY")
        .addHeader("Content-Type", "application/json")
        .build();

try (Response response = client.newCall(request).execute()) {
    System.out.println(response.body().string());
} catch (IOException e) {
    e.printStackTrace();
}

PHP

Here is an example of how to notify menta of a ticket issuance with fictional data using PHP.

<?php
$url = "https://api.mentatickets.com/v1/tickets";
$headers = array(
    "Authorization: YOUR_API_KEY",
    "Content-Type: application/json",
);

$data = array(
    array(
        "ticketOptionId" => "0001",
        "showId" => "4726",
        "externalReferenceEventId" => "the-lion-king-broadway",
        "buyer" => "buyer@emaildomain.com",
        "ticketId" => "111",
        "ticketAccess" => array(
            "type" => "URL",
            "locator" => "https://storage.googleapis.com/default_mentatickets-core/Captura%20de%20pantalla%202023-03-21%20a%20la(s)%2010.46.42.png",
            "status" => "LOCKED"
        ),
        "nominalTicket": {
            "fullName": "John Doe",
            "identification": "12345678"
        }
    )
);

$json_data = json_encode($data);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $json_data);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>

Respuesta JSON

{
    "status": 200,
    "data": [{TICKETDATA}],
    "errors": null
}

Nominal Ticket Parameters

Field	Data Type	Description	Example
fullName	String	User Full Name.	"John Doe"
identification	String	User Identification.	"41253482"

For more detailed information about Ticket and Nominal Asign, please refer to the ticket data section.